package com.xx.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xx.entity.Category;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * <p>
 *  服务类
 * </p>
 *
 * @author myx
 * @since 2025-01-09
 */
public interface ICategoryService extends IService<Category> {

    /**
     * 获取所有分类
     * @return 分类列表
     */
    List<Category> selectList(@Param("name") String name);
    
    /**
     * 插入新的分类
     * @param category 分类对象
     */
    void insertCategory(Category category);

    /**
     * 根据ID获取分类
     * @param id 分类ID
     * @return 分类对象
     */
    Category getCategoryById(Integer id);

    /**
     * 更新分类信息
     * @param category 分类对象
     */
    void updateCategory(Category category);

    /**
     * 根据ID删除分类
     * @param id 分类ID
     */
    void delCategoryById(Integer id);

    /**
     * 根据名称搜索分类
     * @param name 分类名称
     * @return 分类列表
     */
    List<Category> searchByName(String name);

    /**
     * 分页获取分类
     * @param name 分类名称（可选）
     * @param pageNum 当前页码
     * @param pageSize 每页大小
     * @return 分页信息
     */
    Page<Category> getPage(String name, int pageNum, int pageSize);
}
